home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / mint / mgr / readme < prev    next >
Text File  |  1989-01-24  |  6KB  |  140 lines
  1. #                        Copyright (c) 1987 Bellcore
  2. #                            All Rights Reserved
  3. #       Permission is granted to copy or use this program, EXCEPT that it
  4. #       may not be sold for profit, the copyright notice must be reproduced
  5. #       on copies, and credit should be given to Bellcore where it is due.
  6. #       BELLCORE MAKES NO WARRANTY AND ACCEPTS NO LIABILITY FOR THIS PROGRAM.
  7.  
  8. ----------------------------------------------------------------------------
  9.  
  10. Welcome to MGR.   MGR is an network transparent window system for Unix.  This
  11. source contains the SUN version.  MGR has been ported to the Macintosh, and to
  12. system V based unix machines. Look at the first few pages of
  13. doc/usrman/usrman.out for a more detailed desciption of MGR.
  14.  
  15. ----------------------------------------------------------------------------
  16.  
  17. Directory contents:
  18.  
  19. Makefile    Master makefile
  20. README        This file
  21. demo        Mgr demo programs
  22. doc        man pages and user's quide
  23. font-16        16-bit aligned fonts (for sun2's and color suns)
  24. font-32        32-bit aligned fonts (for monochrome sun 3's)
  25. icon        some sample icons
  26. lib        C library interface
  27. menu        some sample menus
  28. misc        Sample startup files, misc. useful commands.
  29. src        MGR source
  30. ----------------------------------------------------------------------------
  31.  
  32. Installation notes:
  33.  
  34. *  MGR has 2 built-in path names; one to find fonts, the other to find icons.
  35.    Both are set with INSROOT in the top level makefile, but may be
  36.    over-ridden on the command line.
  37.  
  38. *  "make" builds mgr and all the demos and utilities. "make install", when
  39.    run as root, put everything into the proper place.
  40.  
  41. *  MGR needs to run as root in order to "chown" your tty's.  Otherwise
  42.    commands like "mesg" and "biff" don't work -- they require you own
  43.    your tty, and the mgr ipc stuff breaks.
  44.  
  45. *  Some old versions of make (pre release 3.0) don't work on multi-level
  46.    makefiles.  In such cases, run all of the sub makefiles by hand, 
  47.    starting at the bottom.  Alternately you can use GNU-make from the
  48.    Free Software Foundation (You need to remove the "#include <sys/types.h>"
  49.    and move "#include <sys/param.h>" to be the 1'st include file) if gnu-make
  50.    won't compile.
  51.  
  52. *  I've installed this release on the following SUNS:
  53.       sun 2/120 running release 1.1
  54.       sun 2/50 running release 2.3
  55.       sun  3/50 3/75, 3/160, 3/260, 3/110, 3/60c running releases 3.0 to 4.0.
  56.       This release used to work on the roadrunner (386 based SUN), but the
  57.       C compiler dumps core on our current RR release.  Also on the 386, the
  58.         internal format of bitmaps is different: you need to bit-swap every
  59.         data byte of the fonts and icons.
  60.  
  61. *  To make and install MGR, become root and type:
  62.       make INSROOT=<rootdir> TARGET=<which_mgr> install
  63.    where <rootdir> is MGR's root directory, usually /usr/mgr and
  64.    <which_mgr> specifies the version of mgr you want.  Common values for
  65.    <which_mgr> are:
  66.       prod        production version - debugging code omitted.
  67.       color        color version
  68.       sun2        sun2 version
  69.       mgr         default version
  70.    src/makefile has a complete list of $TARGET's
  71.    Some of the demos don't work in color.
  72.  
  73. *  To make MGR's home directory in one place, then install it in a different
  74.    place (presumably in anticipation of future symbolic links), do a
  75.       make INSROOT=<mgr_looks_here>
  76.    followed by a
  77.       make INSROOT=<mgr_gets_put_here> install
  78.    
  79. *  Makefile Bugs
  80.    When making the 'color' or other pixrect based versions of mgr (Normally
  81.    MGR doesn't use pixrect; it has its own bitblit code) you need to add
  82.     OTHERLIB=-lpixrect to the make command line.
  83.  
  84. *  MGR bugs.
  85.    - The font format depends upon the underlying bitblit implementation,
  86.      which is why 2 versions of the fonts are needed.  This should be fixed
  87.      in the future, with the introduction of a more portable font format.
  88.      Its currently not possible for the monochrome and color versions of
  89.      MGR to share the same directory, as they each need a different font
  90.      format.
  91.  
  92.    - The SUN color version of MGR is kludgy, due in part to the semantics
  93.      of Sun's pixrect library.  If I ever get around to writing COLOR bitblit
  94.      code, the color versions should go 2x faster.
  95.  
  96. ----------------------------------------------------------------------------
  97.  
  98. *  When trying to run MGR, if you get:
  99.    
  100.    - can't find the screen
  101.      make sure you have a /dev/bwtwo0, otherwise
  102.      cd to /dev, and type "MAKEDEV bwtwo0" as root
  103.  
  104.    - can't get a ptty
  105.      make sure all of /dev/[tp]ty[pq]? are owned by root, mode 666
  106.      and all programs referenced with the "shell" option in the startup
  107.      file exist and are executable
  108.  
  109.    - none but the default font, make sure MGR is looking in the right place.
  110.      type "mgr -V" to find out where mgr is looking.
  111.  
  112.    - completely hung (not even the mouse track moves)
  113.      login to your sun from another terminal (or rlogin) and kill the
  114.      mgr process.
  115.  
  116.   "mgr -V" provides more configuration information than "mgr -v"
  117.  
  118. ----------------------------------------------------------------------------
  119. Acknowlegements:
  120.    Many thanks to Mike Bianchi, who spent many hours fixing little bugs
  121.    and helping to get all of this stuff into a coherent package.
  122.  
  123. ----------------------------------------------------------------------------
  124.  
  125. Stephen A. Uhler
  126. Bell Communications Research
  127. 435 South St.
  128. Morristown, NJ 07960
  129. July, 7 1988 10, 1987
  130.  
  131. Email addresses:
  132.   bellcore!sau 
  133.   sau@bellcore.com
  134.  
  135. ----------------------------------------------------------------------------
  136.  
  137. Please mail any bugs or comments to:
  138. mgr@bellcore.com or bellcore!mgr
  139.  
  140.